生命周期 Hooks

概述

Hermes Gateway 在关键事件点插入自定义逻辑的扩展机制，支持用户自定义和内置两种 Hooks。

关键内容

• Hook 注册方式：通过 @on_event("event_name") 装饰器注册，在特定事件触发时执行自定义逻辑
• 关键事件点：session_start（会话开始）、message_received（消息接收）、session_end（会话结束）等
• 用户自定义示例：会话开始时记录日志、特定关键词（如 "URGENT"）触发高优先级处理、消息内容过滤或转换
• 内置 Hooks（builtin_hooks/）：心跳检测、日报日志、周报摘要、错误通知，开箱即用
• 与工具注册机制的对比：工具注册机制通过 @register_tool 在导入时自动注册工具函数；生命周期 Hooks 通过 @on_event 注册事件回调，两者都是声明式注册模式
• 扩展性价值：无需修改 Gateway 核心代码即可添加自定义行为，符合开闭原则，是 Gateway 平台化能力的重要组成部分

来源

• 05_hermes_gateway.md — Hermes Agent 深度解析第五篇：Gateway 消息网关，2026 年 4 月版本

相关

• Gateway 消息网关 — part_of
• Hermes Agent — implements
• 工具注册机制 — extends